home *** CD-ROM | disk | FTP | other *** search
/ Chip 1997 March / CHIP Mart 1997.iso / SesProg / CONVERT1.ZIP / CONVERT.DOC < prev    next >
Text File  |  1994-09-30  |  19KB  |  407 lines
  1.                   Convert, (c) 1994 Jesus Villena, Spain
  2.                    Universidad Politecnica de Valencia
  3.                          Facultad de Informatica
  4.  
  5.                      INTERNET:  jvillena@dsic.upv.es
  6.                                 usufi4@finf.upv.es
  7.  
  8.                               Version 1.3B
  9.  
  10.  
  11. COPYRIGHT
  12.  
  13. This program is Freeware and may be distributed without any permission of
  14. their author. Their development has been carried out by and for the INTERNET
  15. collective. Collaborates in their improvement and amplification!!!
  16.  
  17. This software is provided as-is. Author makes no warranties on this program.
  18. You use this software at your own risk.
  19.  
  20.  
  21. INTRODUCTION
  22.  
  23. Convert is a MSDOS tool which serves in order to interchange samples between
  24. several formats of sound.  The translation between the several formats offers
  25. the advantage of maintaining the majority of the present information in the
  26. original file if this is possible, i.e. name, loop points, significant
  27. number of bits, number of channels, etc.
  28.  
  29.  
  30. MOTIVATION
  31.  
  32. Convert surged like a domestic project destined to the obtaining of high
  33. quality instruments for the Gravis Ultrasound card starting with files
  34. from professional samplers (Ensoniq EPS, Roland [S] 50, Yamaha TX16W...)
  35. The source code was designed so that out easy their amplification to more
  36. formats. In fact, soon the formats of the most well-known modules were added
  37. (MOD, MTM, FAR, S3M...). A little later they were added the MIDI standard
  38. formats (SDS and SDX) and other formats offered by several manufacturers
  39. (AIFF, IFF, SMP...).
  40.  
  41. At the same time that was added more available formats for the input files,
  42. these same formats, if it was possible, they were available also like
  43. output, so that virtually, any input format would be converted in any
  44. output format.
  45.  
  46.  
  47. FEATURES
  48.  
  49.         - Great quantity of input and output formats:  seeing list.
  50.  
  51.         - Automatic recognition of the input format:  it is not necessary
  52.         specify the type of the input file, Convert detects it automatically.
  53.  
  54.         - Possibility of converting in one pass great quantity of files and
  55.         carry them to some target directory:  They are accepted wildcards
  56.         in order to specify the input files, and a output directory which
  57.         will be filled with the resulting files.
  58.  
  59.         - Ease of use: their utilization is clearly intuitive in order to avoid
  60.         remember difficult combinations of input parameters (for example,if you
  61.         want to use the samples that there is in a file ". PAT" in order to
  62.         utilize them in a module ". MOD", simply specifies -MOD as switch and
  63.         Convert translate each one of the waveforms to the format ". SAM"
  64.         readable for all the mod-editors, without specifying if it is SIGNED or
  65.         UNSIGNED...)
  66.  
  67.         - The program may work with input files of until 16 bits and
  68.         2 channels (Stereo), doing the necessary conversion of these values for
  69.         generating the output format (this is,a WAV file of 16 bits Stereo will
  70.         be converted in 8 bits Mono upon converting it to VOC, for example).
  71.  
  72.         - High probability of success: This program has converted with success
  73.         98% of files I have (others conversion programs generated many errors).
  74.         Especially I have all GKH and AIFF files on ftp.reed.edu (now on
  75.         oak.oakland.edu) and it has converted all very well (except some files
  76.         that was corrupted originally).
  77.  
  78. NEW!!   - Varios Keyboard Disk Images have been added: Directly supports the
  79.         disk image formats GKH and Giebler Enterprises (both are the most
  80.         common in the internet) for VFX-SD, SD-1, TS-10 (DD y HD), VFX-SD, EPS
  81.         (normal, 16 and 16+), and ASR keyboards and racks units. Convert
  82.         doesn't need, as a difference to other programs, external programs for
  83.         converting these disk images.
  84.  
  85. NEW!!   - It Comes in this version with some useful utilities: SND2WAV and JOIN
  86.         SND2WAV converts files that can't carry out Convert (files without
  87.         header) and JOIN links pieces which form a unique sample disk for
  88.         Kurzweil and Ensonig formats.
  89.  
  90. CHANGE  - LoopPoints and WaveSample Length shows samples, nor bytes, similary
  91.         to other packages. Sizes are still in bytes.
  92.  
  93. NEW!!   - A new experimental format has been added, SBK for SoundBlaster AWE32
  94.         users. This format is supported as input and output, but is limited,
  95.         due to unknowing of many features in this format (this is experimental
  96.         because its development has been carry out investigating inside some
  97.         files in this format).
  98.  
  99.  
  100. FORMAT IDENTIFICATION
  101.  
  102. The formats which Convert works in this version are the following:
  103.  
  104.         669         669 Tracker Module
  105.         AIFF        Audio Interchange Format File (AIFF)
  106.         AU          Sun/Next Audio File
  107.         DMF         Delusion Digital Music File
  108.         DSF         Delusion Digital Sound File
  109.         DSM         Digital Sound Module
  110.         FAR         Farandole Composer Module
  111.         FSM         Farandole Composer WaveSample
  112.         F2R         Farandole Linear Module
  113.         F3R         Farandole Blocked Linear Module
  114.         GKH, ED?    Ensoniq Disk Image (VFX, SD, EPS, ASR, TS)
  115.         IFF         Interchange Format File (IFF)
  116.         INS, EF?    Ensoniq Instrument File
  117.         KRZ         Kurzweil K2000 File
  118.         MED         MED/OctaMED Module
  119.         MOD         Protracker/Fastracker/Startrekker Module
  120.         MTM         MultiTracker Module
  121.         OKT         Oktalizer Module
  122.         PAC         SBStudio II Package or Song
  123.         PAT         Gravis Ultrasound Patch
  124.         PSM         Protracker Studio Module
  125.         RAW         PCM Signed Raw Sound File
  126.         SBK         Emu SoundFont Bank (AWE32 Bank)
  127.         SDK         Roland S-550/S-50/W-30 Disk Image
  128.         SDS         MIDI Sample DUMP Standard File
  129.         SDX         Sample DUMP Exchange File
  130.         SF          IRCAM Sound File"
  131.         SMP         Samplevision File
  132.         SND         PCM Unsigned Raw Sound File
  133.         SOU         SBStudio II Sound File
  134.         STM         Scream Tracker 1 & 2
  135.         S3I, SMP    Digiplayer/ST3 Sample File
  136.         S3M         Scream Tracker v3 Module
  137.         TXW         Yamaha TX-16W Wave File
  138.         ULT         UltraTracker Module
  139.         UNI         UNIMOD Module
  140.         UWF         UltraTracker WaveSample
  141.         VOC         Creative Lab's Sound File
  142.         WAV         Microsoft Windows RIFF WAVE
  143.  
  144.  
  145. SYNTAX
  146.  
  147. The form of invoking to this tool is the following:
  148.  
  149.           CONVERT [[InputPath/@SearchFile] [OutputPath] [OutFmt] [Switches]]
  150.  
  151. Where:
  152.  
  153. InputPath is the name of the files to convert.  InputPath consists of a route
  154. and a file name, which accept the usual wilcards of DOS.  Examples of
  155. InputPath would be: \SAMPLES\*.*, ..\SAMPLES\ENSONIQ\*.INS, SAMPLE?.*, etc.
  156.  
  157. SearchFile is optional to InputPath and is a text file which let you specify
  158. files to convert, one file path in each line. Comments can be included behind
  159. simbol #. Order can be achieved also specifying number=filepath. This order
  160. is supplied mainly to support AWE32 program numbers, although is valid for
  161. the rest of formats. E.g:
  162.  
  163.      ---File sample.ini---
  164.         # Sample File to obtain the bank sample.bank
  165.         # Use convert @sample.ini -sbk
  166.         0=c:\sounds\bdrum1.wav
  167.         1=c:\insts\snare2.aif
  168.         8=d:\krz\voices.krz
  169.         # This bank will have the sound bdrum1.wav as program 0
  170.         # the sound snare1.aif as program 1
  171.         # and sounds included in voices.krz as programs 8,9,...
  172.  
  173.  
  174. OutputPath specifies the destination directory where Convert will place the
  175. files converted.  If this directory don't exist, Convert creates it.
  176.  
  177. OutFmt is a switch that allows to specify the output format for the files
  178. to convert to.
  179.  
  180. Switches are -8 and -1 , and serves actually to force 8 bits and mono
  181. conversion.
  182.  
  183. OutFmt may be one of the following:
  184.  
  185. OutFmt      Extension     Offered Feautures
  186. ------      ---------     --------------------------------------------------
  187. -669        ".snd"         PCM Unsigned Raw, 8 bits, Mono
  188. -AIF        ".aif"         8/16 bits, Mono/Stereo, Rate, Loop
  189. -AU         ".au"          8/16 bits LINEAR, Mono/Stereo, Rate
  190. -DMF, -DSF  ".dsf"         8/16 bits, Mono, Rate, Loop
  191. -FAR, -FSM  ".fsm"         8/16 bits, Mono, Loop
  192. -IFF        ".iff"         8 bits, Mono, Rate
  193. -MOD        ".sam"         PCM Signed Raw, 8 bits, Mono
  194. -MTM        ".raw"         PCM Unsigned Raw, 8/16 bits, Mono
  195. -PAC, -SOU  ".sou"         8/16 bits, Mono, Loop
  196. -PAT        ".pat"         8/16 bits, Mono, Rate, Loop, Multiple Waveforms
  197. -RAW        ".raw"         PCM Signed Raw, 8/16 bits INTEL, Mono/Stereo
  198. -SBK        ".sbk"         16 bits, Mono, Loop
  199. -SDS        ".sds"         8/16 bits, Mono, Rate, Loop
  200. -SDX        ".sdx"         8/16 bits, Mono, Rate, Loop
  201. -SF         ".sf"          8/16 bits, Mono/Stereo, Rate
  202. -SMP        ".smp"         16 bits, Mono, Rate, Loop
  203. -SND        ".snd"         PCM Unsigned Raw, 8/16 bits INTEL, Mono/Stereo
  204. -S3M, -S3I  ".smp"         8/16 bits, Mono/Stereo, Rate, Loop
  205. -UWF, -ULT  ".uwf"         8/16 bits, Mono, Loop
  206. -VOC        ".voc"         8 bits, Mono, Rate
  207. -WAV        ".wav"         8/16 bits, Mono/Stereo, Rate, Loop
  208. -OUT        depends        variable (see notes)
  209.  
  210. Notes:
  211.  
  212. If you run Convert without parameters, the program shows a small help.
  213.  
  214. If you have specified only InputPath (or SearchFile) , the program shows
  215. information on the contents of the input files (sample name, number of Bits,
  216. number of channels, loop points, etc...)
  217.  
  218. If you haven't specified OutputPath, it will use the current directory as
  219. target.
  220.  
  221. The output file generated acquires the same name that the input file, if
  222. this has a waveform. If the input file has various waveforms, the name of
  223. each file generated is the original name adding an index that differentiates
  224. it of the others (Caution: this may override existing files with equal names).
  225. If the output format is SBK, the file generated will be named sample.sbk,
  226. except if you use the @SearchFile option to specify file paths; in this
  227. case the name of the ouput file will be the same of the @SearchFile with
  228. ".sbk" as extension.
  229.  
  230. Could happen that the file converted doesn't have the loop points very well
  231. definite; I could secure that in many cases in that this has happened me,
  232. it was an appropriate defect of the original file, no due to the conversion.
  233.  
  234. The switch -OUT has a special meaning and it is only accessible from some
  235. formats.  Basically its meaning is to extract all the waveforms that there is
  236. in the input file to individual files, with the same format (or of it same
  237. "family") that the initial.  Logically, this switch only is available for
  238. that formats that may have multiple waveforms on an only file:
  239.  
  240.         GKH --> INS (they are extracted the contained files in the file GKH)
  241.         PAT --> PAT (each WaveForm is converted into a new PAT file)
  242.         ULT --> UWF
  243.         FAR --> FSM
  244.         669 --> SND (each instrument to PCM RAW 8 bits Unsigned)
  245.         S3M --> S3I
  246.         MTM --> RAW (each instrument to PCM RAW 8/16 bits Unsigned)
  247.         MOD --> SAM (each instrument to PCM RAW 8 bits Signed)
  248.         PAC --> SOU
  249.  
  250.  
  251. ACKNOWLEDGED INPUT FORMATS
  252.  
  253. So that a file may be automatically acknowledged, It should have a header
  254. that define it.  For it, the files with format PCM RAW is not accepted like
  255. valid input formats (this format are supported using sound2wav utility).
  256. The following they are the valid input formats for this version:
  257.  
  258. Format     Acknowledged Characteristics
  259. --------   --------------------------------------------------------
  260. 669        Several waveforms, 8 bits Mono, Loop, Name, Text
  261. AIFF       1 waveform, 1..16 bits, Mono/Stereo, Rate, Loop, Name, Text
  262. AU         1 waveform, 8/16 bits LINEAR/ULAW, Mono, Rate, Text
  263. DMF        Several waveforms, 8/16 bits Mono, Rate, Loop, Name, Text
  264. DSF        1 waveform, 8/16 bits Mono, Rate, Loop, Name
  265. DSM        Several waveforms, 8 bits Mono, Rate, Loop, Name, Text
  266. FAR        Several waveforms, 8/16 bits Mono, Loop, Name, Text
  267. FSM        1 waveform, 8/16 bits Mono, Loop, Name
  268. F2R        Several waveforms, 8/16 bits Mono, Loop, Name, Text
  269. F3R        Several waveforms, 8/16 bits Mono, Loop, Name, Text
  270. GKH, INS   Several waveforms, 16 bits Mono, Rate, Loop, Name
  271. IFF        1 waveform, 8 bits, Mono/Stereo, Rate, Name, Text
  272. KRZ        Several waveforms, 16 bits Mono, Rate, Loop, Name
  273. MED        Several waveforms, 8 bits Mono, Loop, Name, Text
  274. MOD        Several waveforms, 8 bits Mono, Loop, Name, Text
  275. MTM        Several waveforms, 8/16 bits Mono, Loop, Name, Text
  276. OKT        Several waveforms, 8 bits Mono, Loop, Name
  277. PAC        Several waveforms, 8/16 bits Mono, Loop, Name, Text
  278. PAT        Several waveforms, 8/16 bits Mono, Rate, Loop, Name, Text
  279. PSM        Several waveforms, 8/16 bits Mono, Loop, Name, Text
  280. SBK        Several waveforms, 16 bits Mono, Loop, Name, Text
  281. SDK        Several waveforms, 12 bits Mono, Rate, Loop, Name, Text
  282. SDS        1 waveform, 1..16 bits Mono, Rate, Loop
  283. SDX        1 waveform, 1..16 bits Mono, Rate, Loop, Name, Text
  284. SF         1 waveform, 1..16 bits LINEAR, Mono/Stereo, Rate, Text
  285. SMP        1 waveform, 16 bits Mono, Rate, Loop, Name, Text
  286. SOU        1 waveform, 8/16 bits Mono, Loop, Name
  287. STM        Several waveforms, 8 bits Mono, Rate, Loop, Name, Text
  288. S3I        1 waveform, 8/16 bits, Mono/Stereo, Rate, Name
  289. S3M        Several waveforms, 8/16 bits, Mono/Stereo, Rate, Loop, Name, Text
  290. TXW        1 waveform, 12 bits Mono, Rate
  291. ULT        Several waveforms, 8/16 bits Mono, Rate, Loop, Name, Text
  292. UNI        Several waveforms, 8/16 bits, Mono/Stereo, Loop, Name, Text
  293. UWF        1 waveform, 8/16 bits Mono, Rate, Loop, Name, Text
  294. VOC        1 waveform, 8 bits Mono, Rate, Loop, Text
  295. WAV        1 waveform, 1..16 bits, Mono/Stereo, Rate, Loop, Name, Text
  296.  
  297.  
  298. NOTES
  299.  
  300. The GKH format accept Giebler Enterprises image format. The first class files
  301. have ".gkh" extension and include various Ensoniq formats. The second class
  302. have ".ed?" extension, where ? is character which indicates disk tipe (e.g.
  303. ".eda" is a ASR disk image file of Giebler Enterprises, ".edt" es a TS-10 disk
  304. image,...). These formats basically are an Ensoniq disk image.  For it, when
  305. Convert has to carry out the conversion to other formats, first the internal
  306. files are converted to MSDOS files (INS) and subsequently the conversion is
  307. carried out. I recommend you use the -OUT option with this format in order
  308. to avoid this process every time this file is accesed.
  309.  
  310. The INS and KRZ formats support multisample instruments , this is, it allows to
  311. assign various waveforms to several ranges of the MIDI keyboard. This feature
  312. is supported upon converting it to PAT if and only if the ranges are not
  313. overlapped. In this way, a complete percussion kit for example would generate
  314. simply one multisample PAT file.
  315.  
  316. All formats supported can view its internals, although it is compressed or
  317. packed. An error will be displayed if you wants to extract the waves in some
  318. file with unsupported compression or packing.
  319.  
  320. KRZ format supports stereo waveforms, but this version of convert don't
  321. recognize it, and some waves are incorrectly converted (sounds at lower pitch).
  322.  
  323. The SBK format for output in this version only supports an unique wavesample
  324. for each instrument (multiwave instrument will be splitted) and does not
  325. support correct samplerate nor keyboard ranges (I need more info). Furthermore,
  326. convert only will display instruments which WaveSamples are in the RAM area,
  327. do not display ROM based WaveSamples because they cannot be extracted (for
  328. this reason, synthgm.sbk which come with SoundBlaster AWE32 don't display
  329. nothing, this bank uses only the General Midi Set stored in the ROM area of
  330. the board and the file only contains instrument info).
  331.  
  332. I have included the Searchfile (@filename) in this version mainly to let you
  333. to specify which files will compound the SBK bank and which programs will
  334. play each sound. This can be achieved using 'number=sound' (like ultrasnd.ini
  335. but using full path names). Files with multiples waves can missunderstand the
  336. number choosed (only in SBK conversion), E.g:
  337.                         1=tr808.gkh
  338.                         2=kiss.wav
  339. if for example tr808.gkh has 15 wavesamples, it will be played through programs
  340. 1 to 15. The user wants kiss.wav into program 2, but it can't be because
  341. this is in use already. The program seek an available program (16) and assign
  342. it to kiss.wav.
  343.  
  344.  
  345. How to use SBK banks generated with convert?
  346. Once you have obtained a SoundFont Bank (E.g."sample.sbk") you have to download
  347. it into the AWE memory.
  348.  
  349. First, fill the "USER=" field of the "[AWE32] section
  350. of your "sbwin.ini" file, at windows directory, with the path to the bank
  351. generated (E.g."USER=C:\SB16\SFBANK\sample.sbk").
  352.  
  353. Second, inside Windows click at the AWE Control Panel and find "User Custom
  354. Synth" in the Synthesizer Bank section. Later click on Stablish and if you
  355. have memory enough, you will have the sounds in the memory.
  356.  
  357. You can now use Sequencer programs to sound the samples, specifing anyone
  358. program number you have specified.
  359.  
  360.  
  361.  
  362. GRATEFULNESS
  363.  
  364. I thank the disinterested help of Cris-(tobal) in the previous phase test
  365. and his contribution of formats, as well as all anonymous sources of where
  366. I have gotten the specifications of the formats. I am Sorry for my SPAnglish.
  367.  
  368.  
  369. PETITIONS
  370.  
  371. Since I commented at first, this tool surged with ideas of expansion.  For it
  372. I request to all users that is interested in including other formats to the
  373. program, that they will send to me a description of the format, and if it
  374. is possible, some file(s) for testing.
  375.  
  376. The SBK format of the SoundBlaster AWE32 is supported, but I unknown many
  377. of the features it can be included. If you get some technical information
  378. about this format or AWE32 capabilities and programming, please send it to me.
  379.  
  380. Also, I would desire you mail-me any bug or possible improvements of
  381. the program to jvillena@dsic.upv.es or usufi4@finf.upv.es
  382.  
  383.  
  384. START NOW
  385.  
  386. To start to delight with new and vibrant sounds, this is a small list
  387. where you will find them through the INTERNET.  Personally, I have more
  388. than 200 Mbytes of this sounds!!!
  389.  
  390. GKH, INS, EFE, AIFF:    ftp.reed.edu in /eps
  391.                         oak.oakland.edu in /pub2/eps
  392. TXW:                    ftp-ls7.informatik.uni-dortmund.de in /pub/tx16w
  393. SDK:                    lotus.UWaterloo.ca in /pub/sgroup
  394. SDS, SDX:               alf.uib.no in /pub/sds
  395.                         sweaty.palm.cri.nz in sds
  396. PAT:                    archive.epas.utoronto.ca in /pub/pc/ultrasound
  397.                         wuarchive.wustl.edu in /systems/ibmpc/ultrasound
  398. KRZ:                    ftp.uwp.edu in /pub/music/lists/kurzweil
  399.                         cs.utk.edu in /pub/martin/K2000
  400.                         bach.nevada.edu in /pub/K2000
  401. EMAX (future):          sweaty.palm.cri.nz in EMAX
  402.  
  403. You will find a wider list on ftp.cs.ruu.nl in the file /pub/MIDI/DOC/archives
  404.  
  405. HAPPY CONVERSION!!!!!
  406.  
  407.